home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Night Owl 6
/
Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso
/
045a
/
butnlm.zip
/
README
< prev
Wrap
Text File
|
1991-05-03
|
4KB
|
110 lines
** May 3, 1991 **
BUTIL.NLM is a utility which contains a set of commands that allow Btrieve
users to create, maintain and recover Btrieve files at the server. BUTIL.NLM
supports 10 of the commands that are implemented in BUTIL.EXE. The
following is a list of commands that are available and a short description
of each:
* Clone
command format: Load Butil -Clone <New File> <Existing File> [-o<Owner>]
The Clone command creates a new, empty Btrieve file with the same file
structure as an existing file.
* Copy
command format: Load Butil -Copy <Input File> <Output File> [-o<OwnerIn>
[ -O <OwnerOut>]]
The Copy command copies the contents of one Btrieve file to another. It
is usually used to change the defined key characteristics for a Btrieve
file.
* Create
command format: Load Butil -Create <New File> <Description File>
The Create command builds an empty Btrieve file using the structure
specified in a description file.
* Drop
command format: Load Butil -Drop <Btrieve File> <Key Number> [-o<Owner>]
The Drop command is used to remove a supplemental index from a Btrieve
file.
* Index
command format: Load Butil -Index <Btrieve File> <Index File>
<Description File> [-o<Owner>]
The Index command builds an external index file based on a field that
had not been specified as a key before.
* Load
command format: Load Butil -Load <Input File> <Btrieve File> [-o<Owner>]
The Load command allows you to insert records from a sequential file
into a Btrieve file.
* Recover
command format: Load Butil -Recover <Btrieve File> <Output File> [-o<Owner>]
The Recover command reads records from a Btrieve file and writes them to a
sequential file that is compatible with the Load command.
* Save
command format: Load Butil -Save <Btrieve File> <Output File> [<Y|N>
<Index File> | <Key Number>] [-o<Owner>]
The Save command allows you to retrieve records from a Btrieve file by a
specified index path, and creates a sequential file that is compatible
with the Load command.
* Sindex
command format: Load Butil -Sindex <Btrieve File> <Description File>
[-o<Owner>]
The Sindex command creates a supplemental index for an existing Btrieve
file.
* Stat
command format: Load Butil -Stat <Btrieve File> [-o<Owner>]
The Stat command returns characteristics and statistics about a Btrieve
file.
The command line:
Load Butil -Command Parameters
loads the NLM, executes the operation specified and unloads the NLM. You
can either execute these commands from the console prompt, or enter them
into a NetWare Command File(NCF).
It is important to specify the complete path, including the volume name
on the command line or in the NCF file. BUTIL.NLM will return non-zero
status (unsuccessful operation), when a complete path is not specified.
For example, the following command will create a file called MyFile.Btr
in the Sys: volume under the Test subdirectory using description file
MyFile.des:
Load Butil -create Sys:\Test\MyFile.btr Sys:\Test\MyFile.des
If a NCF file is used to execute BUTIL operations, the file can only contain
one BUTIL command. In other words, to recover a damaged Btrieve file using
Recover and Load commands, you need to have two NCF files; one for the
Recover command and one for the Load command. This is because the first
operation loads the NLM and executes the command. Meanwhile, the second
BUTIL operation tries to load the NLM while the first one is still running.
In this case, the second attempt to load the BUTIL NLM will result with the
error "This module is already loaded and cannot be loaded more than once".
There is no advantage for running BUTIL.NLM compared to BUTIL.EXE in many
cases, such as Create, Stat and Drop. It might even be more convenient to
run BUTIL at the workstation for most of the operations. However, it is
much faster to recover files using the NLM version.
The BUTIL.NLM runs under the following combinations:
1. Netware version 3.10 with Btrieve version 5.10.
2. Netware version 3.10 with Btrieve version 5.15.
3. Netware version 3.11 with Btrieve version 5.15.